package com.zenithmind.note.pojo.entity;

import com.zenithmind.common.base.BaseEntity;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.NoArgsConstructor;
import jakarta.validation.constraints.NotNull;

/**
 * 笔记收藏实体类
 * 遵循面向对象设计原则：
 * 1. 单一职责：只负责收藏关系的存储
 * 2. 不变性：收藏关系一旦建立，关键字段不可修改
 * 3. 数据完整性：确保收藏关系的唯一性
 */
@EqualsAndHashCode(callSuper = true)
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
@Schema(name = "笔记收藏实体", description = "笔记收藏实体")
public class NoteFavorite extends BaseEntity {

    @Schema(description = "笔记ID")
    @NotNull(message = "笔记ID不能为空")
    private String noteId;

    @Schema(description = "用户ID")
    @NotNull(message = "用户ID不能为空")
    private String userId;

    @Schema(description = "收藏备注")
    private String remark;

    // ==================== 业务方法 ====================

    /**
     * 验证收藏记录是否有效
     *
     * @return 是否有效
     */
    public boolean isValid() {
        return this.noteId != null && !this.noteId.trim().isEmpty() &&
               this.userId != null && !this.userId.trim().isEmpty();
    }

    /**
     * 判断是否为指定用户对指定笔记的收藏
     *
     * @param noteId 笔记ID
     * @param userId 用户ID
     * @return 是否匹配
     */
    public boolean matches(String noteId, String userId) {
        return this.noteId != null && this.noteId.equals(noteId) &&
               this.userId != null && this.userId.equals(userId);
    }

    /**
     * 设置收藏备注
     *
     * @param remark 备注内容
     */
    public void setRemark(String remark) {
        if (remark != null && remark.length() > 200) {
            throw new IllegalArgumentException("收藏备注不能超过200个字符");
        }
        this.remark = remark;
    }
}